home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 23 / AMIGAplus Sonderheft 23 (2000)(Falke)(DE)[!].iso / Updates / Archivierer / UnZip_v5.32 / Docs / unzipsfx.doc < prev    next >
Text File  |  1999-11-06  |  14KB  |  309 lines
  1.  
  2. UNZIPSFX(1L)                                         UNZIPSFX(1L)
  3.  
  4. NAME
  5.        unzipsfx  -  self-extracting  stub  for  prepending to ZIP
  6.        archives
  7.  
  8. SYNOPSIS
  9.        <name  of  unzipsfx+archive  combo>  [-cfptuz[ajnoqsCLV$]]
  10.        [file(s) ... [-x xfile(s) ...]]
  11.  
  12. DESCRIPTION
  13.        unzipsfx is a modified version of unzip(1L) designed to be
  14.        prepended to existing ZIP archives in order to form  self-
  15.        extracting archives.  Instead of taking its first non-flag
  16.        argument to be the zipfile(s) to  be  extracted,  unzipsfx
  17.        seeks  itself  under  the name by which it was invoked and
  18.        tests or extracts the contents of  the  appended  archive.
  19.        Because  the executable stub adds bulk to the archive (the
  20.        whole purpose of which is to be as small as  possible),  a
  21.        number  of  the  less-vital  capabilities in regular unzip
  22.        have been removed.  Among these are the  usage  (or  help)
  23.        screen,  the listing and diagnostic functions (-l and -v),
  24.        the ability to decompress older compression  formats  (the
  25.        ``reduce,''  ``shrink''  and ``implode'' methods), and the
  26.        ability to extract to a directory other than  the  current
  27.        one.  Decryption is supported as a compile-time option but
  28.        should be avoided unless  the  attached  archive  contains
  29.        encrypted files.
  30.  
  31.        Note  that self-extracting archives made with unzipsfx are
  32.        no more (or less) portable across different operating sys-
  33.        tems  than  is  the unzip executable itself.  In general a
  34.        self-extracting archive made on a particular Unix  system,
  35.        for  example, will only self-extract under the same flavor
  36.        of Unix.  Regular unzip may still be used to  extract  the
  37.        embedded  archive  as with any normal zipfile, although it
  38.        will generate a harmless warning about extra bytes at  the
  39.        beginning  of  the  zipfile.   Despite  this, however, the
  40.        self-extracting archive is technically  not  a  valid  ZIP
  41.        archive,  and PKUNZIP may be unable to test or extract it.
  42.        This limitation is due to the simplistic manner  in  which
  43.        the  archive  is created; the internal directory structure
  44.        is not updated to reflect the extra bytes prepended to the
  45.        original zipfile.
  46.  
  47. ARGUMENTS
  48.        [file(s)]
  49.               An  optional  list  of  archive  members to be pro-
  50.               cessed.  Regular expressions (wildcards) similar to
  51.               those  in Unix egrep(1) may be used to match multi-
  52.               ple members.  These wildcards may contain:
  53.  
  54.               *      matches a sequence of 0 or more characters
  55.  
  56.               ?      matches exactly 1 character
  57.  
  58. Info-ZIP             3 November 1997 (v5.32)                    1
  59.  
  60. UNZIPSFX(1L)                                         UNZIPSFX(1L)
  61.  
  62.               [...]  matches any single  character  found  inside
  63.                      the  brackets;  ranges  are  specified  by a
  64.                      beginning character, a hyphen, and an ending
  65.                      character.   If  an  exclamation  point or a
  66.                      caret (`!' or `^') follows the left bracket,
  67.                      then  the  range  of  characters  within the
  68.                      brackets is complemented (that is,  anything
  69.                      except the characters inside the brackets is
  70.                      considered a match).
  71.  
  72.               (Be sure to quote any character that  might  other-
  73.               wise  be  interpreted  or modified by the operating
  74.               system, particularly under Unix and VMS.)
  75.  
  76.        [-x xfile(s)]
  77.               An optional list of archive members to be  excluded
  78.               from  processing.   Since wildcard characters match
  79.               directory separators (`/'), this option may be used
  80.               to  exclude  any  files that are in subdirectories.
  81.               For example, ``foosfx *.[ch] -x */*'' would extract
  82.               all  C source files in the main directory, but none
  83.               in any subdirectories.  Without the -x option,  all
  84.               C  source  files in all directories within the zip-
  85.               file would be extracted.
  86.  
  87.        If unzipsfx is compiled with SFX_EXDIR defined,  the  fol-
  88.        lowing option is also enabled:
  89.  
  90.        [-d exdir]
  91.               An  optional  directory  to which to extract files.
  92.               By default, all files and subdirectories are recre-
  93.               ated in the current directory; the -d option allows
  94.               extraction in an arbitrary directory (always assum-
  95.               ing  one has permission to write to the directory).
  96.               The option and directory may be concatenated  with-
  97.               out  any  white  space  between them, but note that
  98.               this may cause normal shell  behavior  to  be  sup-
  99.               pressed.    In   particular,  ``-d ~''  (tilde)  is
  100.               expanded by Unix C shells  into  the  name  of  the
  101.               user's  home directory, but ``-d~'' is treated as a
  102.               literal subdirectory ``~'' of  the  current  direc-
  103.               tory.
  104.  
  105. OPTIONS
  106.        unzipsfx supports the following unzip(1L) options:  -c and
  107.        -p (extract to standard output/screen), -f and -u (freshen
  108.        and  update  existing  files  upon  extraction),  -t (test
  109.        archive) and -z (print archive comment).  All normal list-
  110.        ing  options  (-l,  -v  and -Z) have been removed, but the
  111.        testing option (-t) may be used as a ``poor man's''  list-
  112.        ing.    Alternatively,   those   creating  self-extracting
  113.        archives may wish to include a short listing in  the  zip-
  114.        file comment.
  115.  
  116. Info-ZIP             3 November 1997 (v5.32)                    2
  117.  
  118. UNZIPSFX(1L)                                         UNZIPSFX(1L)
  119.  
  120.        See  unzip(1L)  for  a  more complete description of these
  121.        options.
  122.  
  123. MODIFIERS
  124.        unzipsfx currently supports all unzip(1L)  modifiers:   -a
  125.        (convert  text files), -n (never overwrite), -o (overwrite
  126.        without prompting), -q (operate quietly), -C (match  names
  127.        case-insenstively), -L (convert uppercase-OS names to low-
  128.        ercase), -j (junk paths) and -V (retain version  numbers);
  129.        plus  the following operating-system specific options:  -X
  130.        (restore VMS owner/protection info), -s (convert spaces in
  131.        filenames  to underscores [DOS, OS/2, NT]) and -$ (restore
  132.        volume label [DOS, OS/2, NT, Amiga]).
  133.  
  134.        (Support for regular ASCII text-conversion may be  removed
  135.        in  future  versions,  since  it  is simple enough for the
  136.        archive's creator to  ensure  that  text  files  have  the
  137.        appropriate  format  for  the local OS.  EBCDIC conversion
  138.        will of course continue to be supported since the  zipfile
  139.        format implies ASCII storage of text files.)
  140.  
  141.        See  unzip(1L)  for  a  more complete description of these
  142.        modifiers.
  143.  
  144. ENVIRONMENT OPTIONS
  145.        unzipsfx uses the same environment variables as  unzip(1L)
  146.        does,  although this is likely to be an issue only for the
  147.        person creating and testing the  self-extracting  archive.
  148.        See unzip(1L) for details.
  149.  
  150. DECRYPTION
  151.        Decryption  is supported exactly as in unzip(1L); that is,
  152.        interactively with a  non-echoing  prompt  for  the  pass-
  153.        word(s).   See  unzip(1L)  for  details.  Once again, note
  154.        that if the archive has no encrypted  files  there  is  no
  155.        reason  to  use a version of unzipsfx with decryption sup-
  156.        port; that only adds to the size of the archive.
  157.  
  158. EXAMPLES
  159.        To create a self-extracting archive letters from a regular
  160.        zipfile  letters.zip  and change the new archive's permis-
  161.        sions to be world-executable under Unix:
  162.  
  163.            cat unzipsfx letters.zip > letters
  164.            chmod 755 letters
  165.            zip -A letters
  166.  
  167.        To create the same archive under MS-DOS, OS/2 or NT  (note
  168.        the use of the /b [binary] option to the copy command):
  169.  
  170.            copy /b unzipsfx.exe+letters.zip letters.exe
  171.            zip -A letters.exe
  172.  
  173.        Under VMS:
  174.  
  175. Info-ZIP             3 November 1997 (v5.32)